package lc.com.lcpicturebackend.service;

import com.baomidou.mybatisplus.core.conditions.query.QueryWrapper;
import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
import com.baomidou.mybatisplus.extension.service.IService;
import lc.com.lcpicturebackend.model.dto.space.SpaceAddRequest;
import lc.com.lcpicturebackend.model.dto.space.SpaceQueryRequest;
import lc.com.lcpicturebackend.model.entity.Space;
import lc.com.lcpicturebackend.model.entity.User;
import lc.com.lcpicturebackend.model.vo.SpaceVO;

import jakarta.servlet.http.HttpServletRequest;

/**
 * @author 罗超
 * @description 针对表【space(空间)】的数据库操作Service
 * @createDate 2025-02-09 23:56:18
 */
public interface SpaceService extends IService<Space> {

    /**
     * 添加空间
     *
     * @param spaceAddRequest
     * @return
     */
    Long addSpace(SpaceAddRequest spaceAddRequest, User loginUser);

    /**
     * 构建SQL查询
     *
     * @param spaceQueryRequest 用户查询请求
     * @return 返回QueryWrapper
     */
    QueryWrapper<Space> getQueryWrapper(SpaceQueryRequest spaceQueryRequest);

    /**
     * 获取单个空间封装信息，关联创建用户信息
     *
     * @param space
     * @param request
     * @return
     */
    SpaceVO getSpaceVO(Space space, HttpServletRequest request);

    /**
     * 获取空间封装分页信息，关联创建用户信息
     *
     * @param spacePage
     * @param request
     * @return
     */
    Page<SpaceVO> getSpaceVOPage(Page<Space> spacePage, HttpServletRequest request);

    /**
     * 空间数据校验方法，用于更新(admin)和修改(user)空间时进行判断
     *
     * @param space 空间信息
     */
    void validSpace(Space space, boolean add);

    /**
     * 自动填充限额数据
     *
     * @param space 空间
     */
    void fillSpaceBySpaceLevel(Space space);

    /**
     * 校验用户空间权限
     *
     * @param oldSpace  旧空间
     * @param loginUser 登录用户
     */
    void checkSpaceAuth(Space oldSpace, User loginUser);
}
